Skip to main content
Version: 1.2.x

Table of Content (ToC)

Description​

ParsedownExtended facilitates the automatic creation of a Table of Contents (ToC) for your Markdown documents. This feature dynamically includes every heading in the document, streamlining the process by eliminating the need for manually adding anchors to each title. The ToC is generated automatically, enhancing navigability and structure in longer documents.

Configuration Syntax​

To enable or configure the ToC feature, use the setSetting method:

$ParsedownExtended->setSetting('toc', (boolean|array) $value);

Parameters​

Configure ToC with these options:

  • headings (array): Defines which heading levels to include in the ToC.
  • set_toc_tag (string): Sets a custom markdown tag for generating the ToC.

Generating ToC and Content Separately​

ParsedownExtended offers methods to generate ToC and content separately:

  • contentsList(): Returns just the "ToC" as an HTML <ul> list.
  • body(): Parses content without [toc] tag.
  • text(): Parses content with [toc] tag(s).

Example usage:

$content = file_get_contents('sample.md');
$Parsedown = new ParsedownExtended();

$body = $Parsedown->body($content);
$toc = $Parsedown->contentsList();

echo $toc;  // Table of Contents
echo $body; // Main body content

Examples​

Enable ToC​

To enable the ToC feature:

$ParsedownExtended->setSetting('toc', true);

Customize ToC​

Customize ToC with specific configurations:

$ParsedownExtended->setSetting('toc', [
    'headings' => ['h1', 'h2', 'h3'], // Headings to include
    'set_toc_tag' => '[toc]', // Custom ToC tag
]);